“I filled up my disk in 20 minutes! Before Anarchie it would take
me a good hour or more to download the same amount of stuff!” - Russell Baird
As seen on TV (MacNeil/Lehrer show, May 12 1994)
As demoed at Apple's World-wide Developers Conference, May 1994
Second Place in the Best Scriptable Application category of the Everyday AppleScript(tm) Contest, June 1994.
• Contents
What Anarchie Does
Features
Using Anarchie
Using Anarchie via AppleScript
Limitations
Small Print
Warranty
Fine Print
How It Works
Version History
Acknowledgements
The Author
• What Anarchie Does
Anarchie is an FTP and Archie client. It will let you browse FTP sites, download files, or find them using an archie server. It requires System 7 and MacTCP 1.1 or later. Unfortunately many Archie servers are a bit on the flaky side, but don’t worry, just try another server!
•Features
Drag Manager support.
AppleScritable and Recordable.
Queries Archie servers and lists results.
Gives full access to FTP sites in a connectionless manner.
Save bookmarks to FTP sites for later listing or fetching.
Comes with bookmarks to many popular sites.
Fetches files from list windows with just a double-click.
Supports MacBinary decoding.
Forwards fetched files to StuffIt Expander for decoding.
Fetch&Store files and listings using AppleScript independently of archie.
Uses Fetch’s “Suffix Mapping” to determine file type and transfer mode.
Supports UserLand’s MenuSharing.
• Using Anarchie
Note: Anarchie is spelled that way, only the first letter is capitalised, and is pronounced “Anarchy”, not “An archie”.
Simply launch Anarchie. Choose Preferences and fill in the info there. Then choose Archie…, and select a server, choose the kind of search you want done, the maximum number of matches to return, whether the search is case sensitive, and then type in your search request. Click the Search button. Anarchie will then attempt to query the selected server.
Important: Note that some servers apear to be VERY unstable, certainly the Australian one comes and goes. If you can’t get a result from one, just try another. You can fetch an up to date Archie Server List with the “Fetch Server List” menu command. Note also that the larger the number of matches you request, the longer it will take to reply. Usually 20 matches will be plenty.
You can also use Anarchie to simply browse around FTP sites. Choose Get…, then type in the host you want to FTP to (you can also put in a path name after a colon, or you can type (or Paste) in a URL). Then click List and it will fetch a listing of that directory. Then you can double-click folders to fetch further listings. It behaves like TurboGopher in this respect. You can also save references to folders to search them later. Or just use the bookmark files I've provided, for example it lists over a dozen mirrors for the UMich and Info-Mac sites, so if you have trouble connecting to the home sites, try one of the many mirrors.
There are three kinds of archie searches:
simple substring which just looks for the word you type anywhere in the file name.
pattern matching which looks for names like dehqx*.hqx
regular expressions which looks for names like ^dehqx.*\.hqx$
Each can be either case sensitive or case insensitive. Since the Archie protocol doesn’t support all of these options some are converted into strange looking regular expressions.
Anarchie shows you the progress with a wildly inacurate GUESTimate of how long it will take (its not my fault, I just report what the server says). When the server finishes responding, the results will be displayed. You can select some entries and copy them (copies as host:path) or option-copy it (as ftp://host/path, which is the URL (Universal Resource Locator) format). Double-clicking will fetch the file automagically.
Anarchie supports using an alex server. Alex is a file caching system that makes an FTP site with directories like /alex/edu/umich/archive/mac/mac/util/comm. When you fetch a file from there, it gets the listing and the fetched file from the original archive, and caches the result on the server so if anyone else gets the file, they get it from the alex server. This is used in Australia to try to cut down on the ftp use of the Australian<->USA link. It isn’t very reliable.
Anarchie supports using an FTP firewall. The firewall must pretend to be an FTP server, and must accept usernames of the form <user>@<host>, and then carry out the FTP to <host> specifuying a username of <user>. Anarchie does not support any other kind of firewall, nor does it support any kind of UDP firewall.
Anarchie will use the Suffix Mappings you define in Fetch to specify the file type and creator via the file’s suffix (eg .txt). If it doesn’t recognize the file, it will use binary mode, which means that text files will have carriage returns&linefeeds in them. There is a cute little drag&drop utility called Drop Text by Todd Wilson that will fix such files with a minimum of fuss.
If you have Drag Manager (rumoured to be in System 7.5), then Anarchie will allow you to drag files to or from the Display windows to upload or download files. Warning: some versions of the Drag Manager will crash if you drag more than one file to the Finder (or will simply ignore files other than the first one). Also, if you drag files to the trash can, the Drag Manager will show the zooming rectangles to indicate that the operation failed even though it worked fine.
Tips:
- Set Fetch’s Suffix Mapping for .txt, since this is used for View File and other things.
- Make sure you have StuffIt Expander. Setting it to “Delete Originals” is a good idea.
- If an archie server doesn’t answer, try another server.
- If an FTP site is busy, try another. Try less-known servers first to share the load.
- Make bookmarks for your favorite FTP directories (eg info-mac/game!).
- Use “View Selection” to force files to be downloaded in text mode.
- Most of the Finder Shortcuts work in Anarchie’s listing windows.
(eg, command-uparrow opens the parent, typing a name selects it, etc)
- Hold down the option key when you double click/select a menu to edit bookmarks.
- Hold down the option key and choose Edit Retry if the FTP name is slightly wrong.
- Use the Show Log command to refetch files by doubleclicking entries
- The Log will be empty unless you enable logging in the Preferences window.
- Use the Clear menu command to remove entries from the Log.
• Using Anarchie via AppleScript
You can use Anarchie from AppleScript. It has commands to search an archie server, as well as to fetch a file from an arbitrary ftp site. You must be careful to set the timeout parameter though, otherwise if will fail if you try to fetch a large file.
Example AppleScript:
tell application "Anarchie"
with timeout of 5 * 60 seconds
find "dehqx" server "archie.internic.net" matches 20 with window
store file "HD:file" url "ftp://user:password@host/path"
[Note that the URL can be a proper URL, or a simple “host:path” form]
Check out the scripts provide.
You’re on your own when it comes to Frontier, I’ve included some stuff from Leonard Rosenthol, but I have no idea what it does - cool and froody things I expect!
• Limitations
Anarchie requires System 7 and MacTCP 1.1 or later. For large searches, large listings or many listings or searches or whatever, you may need to increase Anarchie’s memory partition (use Get Info in the Finder to do this). To display FTP sites, Anarchie assumes the directory listing will look something like a normal Un•x one, if it doesn’t, it won’t work. I have a document available on how Anarchie (and other programs) parse the LIST output, so if you are writing a server or client, let me know and I’ll send you the document.
• Small Print
This program is Shareware, which means if you use it, you should send me US$10. US dollars or personal checks in US dollars drawn on US banks are fine.
Site Licensing:
World-Wide Source Code License: US$5000
World-wide license: US$2000
Universities or companies site license: US$500
Curtin University and the University of Western Australia are exempt.
Individuals: US$10.
Note that I'd prefer that you use the program and send me a note saying so, than not use the program at all! (it doesn’t help either of us if you delete it and don’t pay, but this is not to say I am happy about it) So even if you are not willing to send me any money, still drop me a line and say hi and tell me what you like or don't like about this program. Of course, I’d much prefer you to pay, obviously. Better yet, get your organisation to buy a site license.
If you purchase a site license, contact me for information on how to make Anarchie automatically set the “I Paid” flag in the Preferences dialog (for those who are interested, I leave the “I Paid” checkbox off on my machine to ensure that the About box is not too annoying and it doesn’t trouble me, so live with it)
You may distribute Anarchie any way you wish as long as you don't charge for it (reasonable download costs such as Compu$erve are ok I guess (although who would call Compu$erve’s download costs reasonable?)). It would probably be a good idea to keep this documentation file with the program, but I’m hardly likely to check up on you now am I! I don’t guarantee any support, but I always answer my Email. If I don’t answer Email its because your message didn’t get to me, or my reply bounced, so try again and include a valid Internet address if you can.
You MAY NOT DISTRIBUTE this program on any disk costing more than $5 without my explicit permission.
• Warranty
This program should do what I’ve described in this document. If it doesn’t, you can simply stop using it. If you pay me, and within a year find that it doesn’t do what I describe here, then you can notify me and I will refund your money and cancel your license.
• Fine Print
Peter Lewis hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. Peter Lewis will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Peter Lewis or an agent of his has been advised of the possibility of such damages. In no event shall Peter Lewis be liable for any damages, regardless of the form of the claim. The person using the software bears all risk as to the quality and performance of the software.
US Governement:
Government End Users: If you are acquiring the Software and fonts
on behalf of any unit or agency of the United States Government, the
following provisions apply. The Government agrees:
(i) if the Software and fonts are supplied to the Department of
Defense (DoD), the Software and fonts are classified as "Commercial
Computer Software" and the Government is acquiring only "restricted rights"
in the Software, its documentation and fonts as that term is defined in
Clause 252.227-7013(c)(1) of the DFARS; and
(ii) if the Software and fonts are supplied to any unit or agency
of the United States Government other than DoD, the Government's rights in
the Software, its documentation and fonts will be as defined in Clause
52.227-19(c)(2) of the FAR or, in the case of NASA, in Clause
18-52.227-86(d) of the NASA Supplement to the FAR.
• How It Works
Anarchie connects to the archie server using the UDP prospero protocol and then, thru a complicated dance of exchanged packets, gets a response back which it reassembles into a list and then displays. The fetching is done with the normal FTP protocol.
• Version History
Still Todo:
Send MACB command once, and deal with it properly for uploads
read/write FTP commands (rename, put, delete)
(put, delete work with DragManager)
other FTP commands (site index, arbitrary)
Moveable modal Find window
AppleScript: "save listing", "list by date/size/"
cmd-click the window title to get popup of directories
support passwords in bookmark listing windows
support saving passwords in saved bookmarks
support dragging entried to the bookmark list to create bookmarks
true grey for grey rounded rect around default buttons
Regexp helper?
way cool help window with topics and stuff and throw away the documentation files.
o autosizing to not showing the path
o option double click to close parent window
o shift tab in get dialog
Option-click headers to sort in reverse (eg au.edu.curtin.info).
"Get Info" like notes for URLs.
Use Expander's Expand event so that I can notify when it's finished.
tcl support?
Remeber last sort, or preference for prefered sort?
fetch a file when it exists should give a helpful prompt.
Try to fetch file.hqx in favour of file.hqx.{Z,z,gz} to see if the site will decode it
Some form of after-search filtering
AE set/get preferences
AE line 3 of window 1
support for gopher and WWW as well ;-)
1.2.1
Bug fix for downloading binary, non-MacBinary files.
1.2.0d7
~UI changes
~Drag Manager drag only if you click on the file name or icon.
1.2.0d6
~pipeline multiple ftp request (especially important for ftp.apple.com).
~Bookmarks with more than one entry.
~Unbugged nonymous ftp.
~No more negative times hopefully :-)
~support NetWare server
1.2.0d5
~Fixed? progress colours
~Drag Manager support
1.2.0d4
~Save Bookmark should possibly add a string like " Bookmark"
~Only pay attention to option in odoc event if sent from the finder.
~revamp zoom code.
~Edit->Clear on Log window
~Update Balloon help
~Save URL bug
1.2.0d3
~active log (still need to implement clear)
~Totally reorged the command keys (sorry!)
~search menu (Find, Find Again, All at once).
~FTP Transcript
~reasonably complete support for (readonly) nonymous FTP
~support partial and absolute paths
~option-copy in Get dialog copies as URL
~paste of URL splits across fields.
~Fixed up the progress bar (oops ;)
~Added some minor changes to interoperate better with Fetch/NewsWatcher.
1.1.4d1
~Started on transcripts
~Fixed a bug that caused some directories to come up empty, and some -49 errors.
1.1.3
Released three times inside 24 hours to become 1.1.3 - don't ask.
1.1.1d3
~Allow listing host:/path/file*
~uniquefy the destination name rather than prompting.
~Cmd-1,2,3 to set radio buttons in each dialog
~Only numbers in Size and Matches fields.
~Option-(return, doubleclick,etc) all bring up the Edit dialog now.
1.1.1d2
~Improve timeout message (just put up "nothing found" window).
~Time remaining in FTP progress.
~Using new DNR code (lots of new bugs I expect)
~Zoom leaves room for disk icons.
~Fixed a bug that caused “zones” to be incorrect on occasion.
~Cmd-. or escape while finding terminates the find and displays the results.
1.1.1d1
~Added prefs for opening the Bookmarks List, and not using Expander.
~Fixed bug with dot (.) not working in patterns.
~Open Folder opens a bookmark listing
~cps display in store/fetch progress?
~Partial results - really this time.
~Minor UI fix
~Added URL support to AppleEvents
~Added support for "current selection" AppleEvent
~Fixed bug with binary mode listing transfers (actually a bug in some servers)
1.1.0d7
~Allow port specification in Firewall.
1.1.0d6
~Force save rating et al after changes.
~Fixed some bugs in the cache code (surprise!)
~Fixed some bugs in the sort code (surprise!)
~Improved FTP listing compatibility (the Newton site broke it).
~Minor UI issues and redid balloon help (Thanks Quinn).
~Minor scroll bar glitch. Sigh.
1.1.0d5
~Cache ftp connections to avoid reopening.
~Increase sort speed by an order of magnitude or two.
~Randomize (Sorry Jim :-)
~Fixed colour icons to use only allowed colours, and added bookmark colour icon
~Trashed pref icons, use file type "pref" to get default icon instead.
~balloon help for Window menu
~Dates are not always for THIS year - they are for withing the last year!
~cmd-uparrow opens parent
1.1.0d4
~Balloon Help for menus.
~Regex helper - tutorial.
~Decode .sit/.cpt files after decoding MacBinary file
~mastermind.cpt.hqx (in game/board) is NOT a directory :-(
~Partial results
~added date and mode to the log.
~added retry menu (it might even work)
~position the "save changes" alert.
~status strings
~out of disk space gives sensible error (as do other errors)
~dir name in window listing instead of "Directory Listing"
~New about box? prompt? display usage? Newbie rating
1.1.0d3
~Log file (does it need more info?)
~Barber poll progress
~Pg up/down, home/end keys
~Balloon Help
~increase memory to 300k?
~Save Bookmarks of list window gives no default name
~Out of memory dialog is not big enough
~archie comes up with no server selected???
~cmd keys for fetch list/fetch file? (cmd-1 & cmd-2)
~Edit *menu* doesn't work
~Make button light up on paste
~TEXT mode solution (View Selection)
~Automagic MacBinary detection.
~option-close box & Command-option-W
~close box -> AppleEvent
~Finder shortcuts
1.1.0d2
~Windows menu.
~Full connectionless anonymous FTP client.
~Saveable URL documents
~Non-modal Get File/Directory dialog.
~double-click dir brings up list of files similar to archie list
1.1.0d1
~Finder-like "Name, Size, etc header" with sorting
~Improved "no result" display
~Support FTP firewalls. (do they all behave the same?)
~Preference to open Find window on startup.
~Added the server name to the listing window’s title.
~Supports windows wider than 1000 pixels (well, I don't have one :-)
~Only use "-" in password for anonymous logins, since some servers don't handle it.
1.0.0 - First release
~AE store & list
~GrowZone
~MenuSharing.
~Fixed popup UI to abide by Apple’s HIG.
~Alex server support
~Multiple selections in the list window.
~Scriptable&Recordable fetch command
~Fetch SuffixMapping
~Send to StuffIt Expander
~Prefs dialog
• Acknowledgements
Thank go to Dmitry Boldyrev & Igor Livshits for the icons, and to various people on my beta list for their suggestions. Quinn & Leonard get the award for most implemented suggestions.
Thanks again to Leonard for the Frontier stuff. Don’t ask me what it is, I’m just including it - anything Leonard writes is certainly going to be good :-)
Thanks also to Chris W Johnson and the folks at University of Texas at Austin for hosting the archie server list fetched by “Fetch Server List”. You might like to check out their archive at microlib.cc.utexas.edu:microlib/mac (preferably after hours).
Thanks also to Jean-Pierre Kuypers for the french translation.
• The Author
Programs written by me:
Anarchie 1.2.1 - Macintosh FTP and Archie client.
TFTPd 1.0.0 - Macintosh TFTP server.
CDIconKiller 1.0.0 - Supress custom icons on CDs (written with Quinn).
MungeImage 1.1.0 - Mount DiskCopy images (written with Quinn).
